home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / xdvi-dos / readme < prev    next >
Text File  |  1992-10-21  |  12KB  |  269 lines
  1. INSTALLATION INSTRUCTIONS
  2.  
  3. To install, do the following:
  4.     1.    Read the ENVIRONMENT section of xdvi_man.sed to determine the correct
  5.     default values for the XDVIFONTS and XDVISIZES environment variables.
  6.     Edit the Imakefile or Makefile and change the values of the make
  7.     variables DEFAULT_FONT_PATH and DEFAULT_FONT_SIZES to these values.
  8.     If your site uses virtual fonts, do the same thing with the
  9.     DEFAULT_VF_PATH variable.  Note that support of virtual fonts in xdvi
  10.     does not include support of built-in Postscript<tm> fonts.
  11.  
  12.     (Note:  for X10 compilation, use Makefile_10 instead of Makefile.)
  13.  
  14.     You may also wish to change other compilation options; they are
  15.     described later in this file.
  16.  
  17.     2.  make xdvi and try it out.  If the settings in step one are incorrect,
  18.     you can use the corresponding environment variables to quickly try out
  19.     different values.  If the values set in step 1 were incorrect,
  20.     rm font_open.o and go back to step 1.
  21.  
  22.     If you get the error that the #include file <stdlib.h> does not exist,
  23.     then you should include -DX_NOT_STDC_ENV in the DEFS variable in the
  24.     Makefile or Imakefile.  In X11R5 or later this problem should not
  25.     come up.
  26.  
  27.     3.  make xdvi.man.
  28.  
  29.     4.  Install xdvi and xdvi.man.
  30.  
  31.  
  32.     The X10 flag only affects xdvi.c (and the flags MSBITFIRST, BMSHORT,
  33.     and BMLONG, see below).
  34.  
  35.     Note in particular the compilation flags USE_PK, USE_GF, and USE_PXL,
  36.     which can be set to reflect which font formats are actually used at
  37.     your site.
  38.  
  39. Other compilation flags are:
  40.     SYSV        (dvi_init.c font_open.c xdvi.c)  Set for System V
  41.             compilation.
  42.     VMS        Set for VMS compilation.
  43.     MSBITFIRST    (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c)  Store
  44.             bitmaps internally with the most significant bit at
  45.             the left.  For performance reasons, it would be best
  46.             to set this to coincide with what your server uses.
  47.             Use the keystroke '^P' to find information in this
  48.             regard.  Generally, you should use MSBITFIRST if and
  49.             only if '^P' reports bitord = 1, and BMSHORT/BMLONG
  50.             (below) should be set to match whatever '^P' reports
  51.             under "Unit =".  But, if bitord = byteord, then the
  52.             latter setting should not matter much.
  53.     BMSHORT        (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c)  Store
  54.             bitmaps in short integers instead of bytes.  See
  55.             MSBITFIRST for other relevant comments.  To check
  56.             performance, you can use:
  57.                 time xdvi -d 8 file.dvi
  58.     BMLONG        (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c)  Store
  59.             bitmaps in long integers instead of bytes.
  60.     ALTFONT        (xdvi.c)  Default font to use if the font named in the
  61.             dvi file cannot be found.  Can be set to NULL.  By
  62.             default, it is "cmr10".
  63.     SEARCH_SUBDIRECTORIES (font_open.c)  Enable recursive searching of
  64.             subdirectories for font files (* and ** specifiers).
  65.             This also enables the TEXFONTS_SUBDIR environment
  66.             variable and the DEFAULT_SUBDIR_PATH makefile variable.
  67.     XDVIFONTS_ONLY    (font_open.c) Never check the TEXFONTS environment
  68.             variable.  Normally xdvi checks TEXFONTS if the
  69.             XDVIFONTS variable is not set.  This option is
  70.             recommended if the version of TeX in use requires
  71.             that the TEXFONTS variable be set.  See the relevant
  72.             paragraph in xdvi_man.sed for more details.  This
  73.             option turns off that paragraph.
  74.     NOTOOL        (X11 only; xdvi.c)  Compile using raw X calls.
  75.     BUTTONS        (xdvi.c)  Put radio buttons on the right side of the
  76.             window for commonly used commands.
  77.     A4        (xdvi.c)  Use European size paper by default.
  78.     NOQUERY        (xdvi.c)  Set this if you have trouble compiling the
  79.             definition of drawingWidgetClass.
  80.     TEXXET        (everything)  Enables op-codes 250 and 251 (used for
  81.             right-to-left languages).
  82.     BDPI        (xdvi.c) Default number of pixels per inch to use.
  83.     GREY        (everything)  Use greyscale anti-aliasing for
  84.             displaying shrunken bitmaps.
  85.     MAKEPK        (font_open.c)  If a font is not found, then try to
  86.             call Metafont to create the font.  When using this
  87.             option, remember to set the paths in MakeTeXPK
  88.             correctly for your site, and be sure that the
  89.             destination directory for MakeTeXPK appears in your
  90.             DEFAULT_FONT_PATH variable.
  91.     MAKEPKCMD=\"/usr/local/tex/bin/MakeTeXPK\" (font_open.c)  Same as the
  92.             above, but this variant explicitly declares which
  93.             command to use to create the font.
  94.  
  95. All flags should be set in the appropriate Makefile via the variable ``DEFS''.
  96.  
  97. ================================================================
  98.  
  99.     This program is the combined work of many people, including but not
  100. restricted to:
  101.     Eric Cooper, CMU
  102.     Bob Scheifler, MIT LCS
  103.     Paal Kvamme, Norwegian Institute of Technology
  104.     H\aa vard Eidnes, Norwegian Institute of Technology
  105.     Mark Eichin, MIT SIPB
  106.     Paul Vojta, UC Berkeley
  107.     Jeffrey Lee, U of Toronto
  108.     Donald Richardson, Clarkson Univ.
  109. At the present time, the person to send bug reports to is Paul Vojta,
  110.     vojta@math.berkeley.edu.
  111.  
  112. In addition to the various comp.sources.x archives, current versions of this
  113. program can also be obtained via anonymous ftp from the following location:
  114.     export.lcs.mit.edu    [18.24.0.12]    file contrib/xdvi.tar.Z
  115. To ease the load on export, you may also check other X archives, for example:
  116.     gatekeeper.dec.com    [16.1.0.2]    file pub/X11/contrib/xdvi.tar.Z
  117.  
  118. Paul Vojta, 17 March 1992
  119.  
  120. ================================================================
  121.  
  122. Note for IBM RS6000 users:  some of the libraries are in non-obvious places:
  123.  
  124.     libXmu    /usr/lpp/X11/Xamples/lib/Xmu/libXmu.a
  125.     libXaw    /usr/lpp/X11/Xamples/lib/Xaw/libXaw.a
  126.  
  127. These should be moved to /usr/lib or some more reasonable place (or use
  128. symlinks), and ditto for the include files, which are initially placed
  129. in /usr/lpp/X11/Xamples/include.
  130.  
  131. ================================================================
  132.  
  133. Notes of historical nature follow.  Most recent changes are listed at the end
  134. of the file.
  135.  
  136. ================================================================
  137.  
  138. This directory contains a version of xdvi capable of reading GF, PXL
  139. and PK font files. This version of xdvi is based on the source that
  140. "came with" X v10r3. Xdvi was modified by Paal Kvamme at the Norwegian
  141. Institute of Technology, based on the modifications I had made to
  142. dviimp (a dvi to ImPress converter). This code was again more or less
  143. directly translated from the web source of PKtoPX.
  144.  
  145. If you discover (and fix) any bugs in this code, please notify me, so
  146. I can make the corresponding changes myself.
  147.  
  148. ---------
  149. H}vard Eidnes    (TeXish: H\aa vard Eidnes)
  150. Division of Computer Science
  151. Norwegian Institute of Technology
  152.  
  153. E-Mail: h_eidnes%vax.runit.unit.uninett@nta-vax.arpa
  154. ================================================================
  155. Also has path search added by Mark Eichin, looks in TEXFONTS
  156. ================================================================
  157.  
  158. ================================================================
  159. Additional notes:
  160.     X11 version now works on the IBM PC/RT as well as VAX.
  161.             [eichin:19880313.1330EST]
  162. ================================================================
  163. *MORE* fixes (for athena release locker) [eichin:19880722.2058EST]
  164. Fixes:
  165.     narrow vertical and horizontal lines no longer disappear.
  166.     bogus underlining (which usually occured on even sample sizes
  167. of odd sized characters) no longer occurs.
  168.     -S number (or typing number followed by S) will adjust the
  169. sampling fraction; 0 is special cased to mean if anything in the
  170. sampled zone is set, set the sample, else clear it. Interesting to
  171. experiment with, though not useful for reading (the default value of 3
  172. is just right.)
  173.     -display and -geometry arguments work (so do old style forms,
  174. though they were broken before)
  175.     fixed one of the PK debugging messages to print the correct
  176. font name instead of printing the pointer as text.
  177.     included Ken Raeburn <raeburn>'s changes to support multiple
  178. screens.
  179. ================================================================
  180. More changes:
  181.  
  182.     1.  Incorporated the bitmap under a viewport widget using the toolkit
  183.     (X11 only);
  184.     2.  Added an icon and icon geometry arguments (X11 only);
  185.     3.  Supported window resizing;
  186.     4.  Added a 'c' option to move whatever is currently under the cursor to
  187.     the center of the window;
  188.     5.  Added an 'R' option to reread the .dvi file, and added logic to make
  189.     'R' happen automatically whenever any part of the window is exposed
  190.     and the dvi file changes (so that you can iconify xdvi, run tex,
  191.     deiconify xdvi, and voila!);
  192.     6.  Added a 'magnifying glass':  when you push a button, a window pops
  193.     up, showing the region of the page, unshrunk;
  194.     7.  Added support for gf fonts;
  195.     8.  Upgraded font searching (at our site we use /usr/custom/tex82/gf
  196.     for gf fonts, /usr/custom/tex82/pk for pk fonts, etc.);
  197.     9.  Made numerous internal changes (removed all the lint I could,
  198.     made unshrunk bitmaps permanently resident, which speeds up size
  199.     changing, made table.h necessary only for pxl.h, split up the source
  200.     file into xdvi.c, dvi.c, gf.c, pxl.c, and pk.c, made shrinking occur
  201.     relative to the character's hot point, etc.)
  202.    10.  The program reads SIGIO signals and processes incoming events
  203.     immediately, so that it can stop displaying things that would be
  204.     erased anyway.  If these interrupts are not coming through, then
  205.     it also checks for incoming events every several dozen characters
  206.     displayed.
  207.    11.  Further split up dvi.c into dvi_init.c and dvi_draw.c; added
  208.     compilation options for various internal bitmap representations.
  209.     Fixed it so gcc won't give warnings, and so it works with R3 toolkit.
  210. --  Patchlevel 2:  --
  211.    12.  Added MAXCHARS compilation option.  Eliminated the nonsense with
  212.     generating table.h.
  213. --  Patchlevel 3:  --
  214.    13.  Added -altfont command line option and SYSV compilation option.
  215. ================================================================================
  216.  
  217. 4/1989  Modified for System V boxes. -DSYSV compiler option.
  218.  
  219. Donald Richardson, donr@crystal.mie.clarkson.edu
  220.  
  221. ================================================================================
  222. --  Patchlevel 4:  --
  223.    14.  Removed MAXCHARS compilation option.  It's automatic now.  Made X10
  224.     scrolling smoother.  Implemented the moving magnifying glass.
  225. --  Patchlevel 5:  --
  226.    15.  Implemented compilation without the toolkit, as well as scrollbars
  227.     and tpic support in X10.  Also this version should work with color
  228.     VAXstations, although overstrike characters will come out incorrectly.
  229.    16.  Fixed a bug in gf reading routines:  specials at the beginning of
  230.     a character def. were not being processed.  Thanks to
  231.     kevin@amath.washington.edu for a bug report and fix.
  232.    17.  Added 'k' keystroke.
  233. --  Patchlevel 6:  --
  234.    18.  Added buttons on the right side of the window.
  235.    19.  Added -pagewidth and -pageheight command line options and A4
  236.     compilation option.
  237.    20.  Added a yet more robust font finding algorithm.
  238. --  Patchlevel 7:  --
  239.    21.  Replaced -pagewidth and -pageheight options with -paper.
  240. --  Patchlevel 8:  --
  241.    22.  Added compatibility for X11R4 and VMS.  Fixed up alignment of rules.
  242. --  Patchlevel 9:  --
  243.    23.    Removed obsolete '#' and '=' options from the X11 version:  they
  244.     interfere with emacs.
  245. --  Patchlevel 10: --
  246.    24.    Implemented arrow keys, expert mode, searching for the font's actual
  247.     size first, the -[xy]offset and -sw options, and numerous bug fixes.
  248. --  Patchlevel 11: --
  249.    25.    Implemented recursive searching for font files in subdirectories.
  250.    26.    Changed +sw to -hushspecials and implemented -hush.
  251.    27.    Modified mksedscript so that the man page comes out neater.
  252.    28.  Added a -keep option and resource to match the `k' keystroke.
  253. --  Patchlevel 12: --
  254.    29.  Implemented virtual fonts (this does not include built-in
  255.     Postscript<tm> fonts!!!).
  256.    30.    X11R5 support, and numerous bug fixes.
  257. --  Patchlevel 13: --
  258.    31.  Added support for TeXXeT.
  259. --  Patchlevel 14: --
  260.    32.  Added support for greyscale anti-aliasing.
  261. --  Patchlevel 15: --
  262.    33.  Added support for MakeTeXPK, as in dvips.
  263. --  Patchlevel 16: --
  264.    34.    In the code for greyscale anti-aliasing, try to allocate a colormap
  265.     so that GXor operations can be used for drawing.  Also interpolate
  266.     between foreground and background colors.
  267.  
  268. Paul Vojta, vojta@math.berkeley.edu
  269.